Browse: 🏠 · Solutions · Connectors · Methods · Tables · Content · Parsers · ASIM Parsers · ASIM Products · Logic Apps · 📊
This playbook is triggered by a Microsoft Sentinel Alert. It extracts IP addresses, domains, and certificate file hashes (SHA256) from alert entities, then queries the Censys API to retrieve enrichment data for hosts, web properties, and certificates. The enriched data is ingested into Log Analytics Workspace custom tables (CensysHostAlert, CensysWebPropertyAlert, CensysCertificateAlert). If the alert is associated with an incident, the playbook invokes the CensysAddIncidentComment sub-playbook
| Attribute | Value |
|---|---|
| Type | Playbook |
| Solution | Censys |
| Source | View on GitHub |
This content item queries data from the following tables:
| Table | Transformations | Ingestion API | Lake-Only |
|---|---|---|---|
CensysCertificateAlert_CL 🔶 |
? | ✓ | ? |
CensysHostAlert_CL 🔶 |
? | ✓ | ? |
CensysWebPropertyAlert_CL 🔶 |
? | ✓ | ? |
This playbook uses 5 Logic App connectors / built-in actions:
| Connector / Action | Type | Connections | Actions |
|---|---|---|---|
azureloganalyticsdatacollector |
Managed | 1 | 3 |
azuresentinel |
Managed | 1 | 3 |
keyvault |
Managed | 1 | 1 |
http |
Built-in | 0 | 5 |
workflow |
Built-in | 0 | 1 |
azureloganalyticsdatacollector (Managed)| Action | Method | Endpoint | Other |
|---|---|---|---|
| Ingest_Censys_Host_Data | post | /api/logs |
— |
| Ingest_Censys_Certificate_Data | post | /api/logs |
— |
| Ingest_Censys_Web_Property_Data | post | /api/logs |
— |
azuresentinel (Managed)| Action | Method | Endpoint | Other |
|---|---|---|---|
| Entities_-_Get_IPs | post | /entities/ip |
— |
| Entities_-_Get_FileHashes | post | /entities/filehash |
— |
| Alert_-_Get_incident | get | /Incidents/subscriptions/@{encodeURIComponent(triggerBody()?['WorkspaceSubscriptionId'])}/resourceGroups/@{encodeURIComponent(triggerBody()?['WorkspaceResourceGroup'])}/workspaces/@{encodeURIComponent(triggerBody()?['WorkspaceId'])}/alerts/@{encodeURIComponent(triggerBody()?['SystemAlertId'])} |
— |
keyvault (Managed)| Action | Method | Endpoint | Other |
|---|---|---|---|
| Get_Censys_API_Token | get | /secrets/@{encodeURIComponent('Censys-Access-Token')}/value |
— |
http (Built-in)| Action | Method | Endpoint | Other |
|---|---|---|---|
| HTTP_Call_to_Fetch_Host_Data | POST | @{variables('base_url')}/@{variables('api_version')}/global/asset/host |
— |
| HTTP_Call_to_Fetch_Certificates_Data | POST | @{variables('base_url')}/@{variables('api_version')}/global/asset/certificate |
— |
| HTTP_Call_to_Fetch_WebProperty_Data | POST | @{variables('base_url')}/@{variables('api_version')}/global/asset/webproperty |
— |
| Probe_Enrichment_API_Connectivity | GET | @{variables('base_url')}/@{variables('api_version')}/global/asset/enrichment/host/@{encodeURIComponent(variables('probe_ip'))} |
— |
| HTTP_Call_to_Fetch_Host_Enrichment_Data | GET | @{variables('base_url')}/@{variables('api_version')}/global/asset/enrichment/host/@{encodeURIComponent(items('For_Each_IP_For_Enrichment'))} |
— |
workflow (Built-in)| Action | Method | Endpoint | Other |
|---|---|---|---|
| CensysIncidentEnrichment | — | — | workflowId=[concat('/subscriptions/', subscription().subscriptionId, '/resourceGroups/',resourceGroup().name,'/providers/Microsoft.Logic/workflows/',trim(parameters('IncidentEnrichmentPlaybookName')))]triggerName= When_an_HTTP_request_is_received |
📄 Source: CensysAlertEnrichment/readme.md
This playbook is triggered by a Microsoft Sentinel Alert. It extracts IP addresses, domains, and certificate file hashes (SHA256) from alert entities, then queries the Censys API to retrieve enrichment data for hosts, web properties, and certificates. The enriched data is ingested into Log Analytics Workspace custom tables (CensysHostAlert, CensysWebPropertyAlert, CensysCertificateAlert). If the alert is associated with an incident, the playbook invokes the CensysAddIncidentComment sub-playbook to add enrichment data as incident comments.
By default this playbook first queries the Censys Host Enrichment API (v3/global/asset/enrichment/host) for the IP entities, which returns the standard host record plus GreyNoise, IPinfo (network and privacy) and Mallory third-party data. The enrichment API is a separately entitled feature, so a single probe call decides whether it is available: on 403 (not entitled) or 409 every IP falls back to the standard bulk host API, and any individual IP the enrichment API cannot return falls back on its own. Transient statuses (429, 5xx) and 404 keep the enrichment path enabled. A 401 response terminates the run with an authentication error pointing at the Key Vault secret and Organization ID. Set the UseHostEnrichment parameter to false to always use the standard host API.
Once deployment is complete, authorize each connection.
Add access policy for the playbook's managed identity to read secrets from Key Vault.
Assign Microsoft Sentinel Responder role to the playbook's managed identity.
Browse: 🏠 · Solutions · Connectors · Methods · Tables · Content · Parsers · ASIM Parsers · ASIM Products · Logic Apps · 📊